From 1ec2d1d9f1efcb9546d519d10622933e90f07b20 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 25 Mar 2020 17:13:37 -0400
Subject: [PATCH] shortcutmanager: Add some more docs

---
 gtk/gtkshortcutmanager.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gtk/gtkshortcutmanager.c b/gtk/gtkshortcutmanager.c
index 71a1b35eb1..c6530c0efe 100644
--- a/gtk/gtkshortcutmanager.c
+++ b/gtk/gtkshortcutmanager.c
@@ -30,6 +30,13 @@
  *
  * The GtkShortcutManager interface is used to implement
  * shortcut scopes.
+ *
+ * This is important for #GtkNative widgets that have their own surface,
+ * since the event controllers that are used to implement managed and
+ * global scopes are limited to the same native.
+ *
+ * Examples for widgets implementing #GtkShortcutManager are #GtkWindow
+ * and #GtkPopover.
  */
 
 G_DEFINE_INTERFACE (GtkShortcutManager, gtk_shortcut_manager, G_TYPE_OBJECT)
-- 
2.30.2